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PART 5 

CHAPTER 1 

USING DEVICE DRIVERS OUTSIDE DOS/BATCH 


Subroutines to handle I/O transfers between a PDP-11 and each of its peripheral 
devices are developed as required for use within the Disk Operating System DOS /BATCH 
These subroutines are made available within an I/O Utilities Package for the benefit 
of PDP-11 users who have configurations unable to support DOS/BATCH or who wish to 
run programs outside DOS/BATCH control. 

All the subroutines associated with one peripheral device form an entity known as a 
device driver. This part provides a general description of a driver and shows how 
it can be used in a stand-alone environment. The unique properties of each driver 
are discussed in separate documents, which are made available as part of the Device 
Driver Package. The I/O utilities package for any system is determined by the 
peripherals of that system. Thus, the full documentation for a particular package 
consists of this document and applicable supplements. 



PART 5 
CHAPTER 2 
DRIVER FORMAT 

2.1 STRUCTURE 

The basic principle of all drivers under the DOS/BATCH Monitor is that they must 
present a common interface to the routines using them in order to provide device- 
independent operation. The subroutines are structured to meet this end. Moreover, 
a driver can be loaded anywhere in memory under Monitor Control. Its code is always 
position-independent (PIC) . 1 

A detailed description of a driver is found in Chapter 5-4. This section describes 
driver interfaces. 

2.1.1 Driver Interface Table 

The first section of each driver is a table which contains, in a standard format, 
information on the nature and capabilities of the device it represents and entry 
points to each of its subroutines. The calling program can use this table as 
required, regardless of the device being called. See Section 5-4.1 for a detailed 
description of the table. 

2.1.2 Setup Routines 

Each driver is expected to handle its device under the PDP-11 interrupt system. 

When called by a program, therefore, a driver subroutine merely initiates the required 
action by setting the device hardware registers appropriately. It returns to the 
calling program by a standard subroutine exit. 

The main setup routines prepares for a data transfer to or from the device, using 
parameters supplied by the calling program. Normally, blocks of data are moved at 
each transfer. The driver returns control to the program only when the whole 
block has been transferred or when it is unable to continue because there is no 
more data available. 


^ee Part 6 for information on PIC. 
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The driver can also contain subroutines by which the calling program can request 
(1) start-up or shut-down action, sytch as leader or trailer functions for a paper 
tape punch, or (2) some special function provided by the device hardware (or a 
software simulation of that for some- similar device) , e.g., rewind of a magnetic 
tape or DECtape. 

2.1.3 Interrupt Servicing 

The driver routine to service device interrupts is particularly dependent upon the 
device hardware provisions for controlling transfers. In general, the driver 
determines the cause of the interrupt and checks whether the last action was 
performed correctly or was prevented by some error condition. If more device 
action is needed to satisfy the program request, the driver again initiates that 
action and takes a normal interrupt exit. If the program request has been fully 
met, control is returned to the program at an address supplied at the time of the 
request. 

2.1.4 Error Handling 

Device errors can be handled in two ways. There are some errors for which recovery 
can be programmed; the driver, if appropriate, attempts this itself (as in the case 
of parity or timing failure on a bulk-storage device) or recalls the program with the 
error condition flagged (as at the end of a physical paper tape) . Other errors 
normally require external action, perhaps by an operator. The driver calls a DOS/ 
BATCH error handler via an IOT call with supporting information on the processor 
stack. 

2.2 INTERFACE TO THE DRIVER 

2.2.1 Control Interface 

The principal link between a calling program and any driver subroutine is the first 
word of the driver table (link word) . In order to provide the control parameters 
for a device operation, the calling program prepares a list in a standardized form 
and places a pointer to the list in the link word. The called driver uses the 
pointer to access the parameters. The driver can place return status information 
(if needed) in the list area via the link word. The first word of the driver table 
can also act as a busy indicator; if it is 0 , the driver is not currently performing 
a task, but if it contains a listpointer, the driver can be assumed to be busy. 

Since most drivers support only one job at a time, the link word state is significant. 
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2.2.2 Interrupt Interface 


Although the driver expects to use the interrupt system, it does not itself ensure 
that its interrupt vector in the memory area below 400 has been set up correctly; 

O 

the Monitor takes care of this. However, the driver table contains the information 
required to initialize the appropriate vector. 
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PART 5 
CHAPTER 3 
STAND-ALONE USE 


Because each driver is designed for operation within the device-independent frame- 
work of the Monitor, it can be similarly used in other applications. Since the 
easiest way to use the driver is to assemble it with the program that requires 
it, this method will be described first. Other possible methods will be discussed 
later. 

3.1 DRIVER ASSEMBLED WITH PROGRAM 


*3.1.1 Setting Interrupt Vector 


As noted in Section 5-2. 2. 2, the calling program must initialize the device 
transfer vectpr within memory locations 0-377. The address of the driver's interrupt 
entry point can be identified on the source listing by the symbolic name which appears 
as the contents of the Driver Table Byte, DRIVER+5. The priority level at which the 
driver expects to process the interrupt is at byte DRIVER+6. For a program which 
can reference position-dependent code, the setup sequence-* might be: 


MOV #DVRINT, VECTOR ;SET INT. ADDRESS 

MOVB DRIVER+6 ,VECT0R+2 ;SET PRIORITY 

CLRB VECTOR+3 ; CLEAR UPPER STATUS BYTE 


where the Driver Table Byte (at DRIVER+5) shows the foilwing instruction: 


• BYTE DVRINT-DRIVER 


If the program must be position-independent, it can take advantage of the fact that 
the Interrupt Entry address is stored as an offset from the start of the driver, as 
illustrated above. In this case, a sample sequence might be: 


MOV 

PC , Rl 


;GET DRIVER START 

ADD 

#DRIVER- . ,R1 



MOV 

#VECT0R,R2 


; . . . & VECTOR ADDRESSED 

CLR 

@R2 


; SET INT. ADDRESS 

MOVB 

5 (Rl) ,@R2 


; . . .AS START ADDRESS+OFFSET 

ADD 

R1,(R2) + 



CLR 

@R2 


SET PRIORITY 

MOVB 

6 (Rl) , @R2 
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3.1.2 Parameter Table for Driver Call 


For any call to the driver the program must provide a list of control arguments 
mentioned in Section 5-2. 2.1. This list must adhere to the following format: 1 

[SPECIAL FUNCTION POINTER] 2 
[BLOCK NO.] 3 

STARTING MEMORY ADDRESS FOR TRANSFER 

NO. OF WORDS to be transferred (2's complement) 

STATUS CONTROL showing in Bits: 

0-2 Function (octally 2=WRITE, 4=READ) 4 

8-10 Unit (if Device can consist of several units, e.g., DECtape) 

11 Direction for DECtape -travel (0=Forward) 

ADDRESS for RETURN ON COMPLETION 
[RESERVED FOR DRIVER USE] 5 

The list can be assembled in the required format since its content will not vary. 

The driver can return information in this area; this will not corrupt the program 
data. 

On the other hand, most programs will probably use the same list area for several 
tasks or even for different drivers. In this case, the program must contain 
the necessary routine to set up the list for each task before making the driver 
call. The driver may refer to the list again when it is recalled by an interrupt 
or when returning information to the calling program. Therefore, the list must not be 
changed until any driver has completed a function requested; for concurrent opera-? 
tions, different list areas must be provided. 


x In some cases, it can be further extended as discussed in later sections. 

2 Required only if Driver is being called for Special Function; addresses a Special 
Function Block. 

3 Required only if the device is bulk storage (e.g., Disk or DECtape). 

4 Most devices transfer words regardless of their content, i.e., ASCII or Binary. 
Some devices (e.g.. Card Reader) may be handled differently depending on the mode 
for these. Bit 0 must also be set to indicate ASCII=0, Binary =1. In these cases, 
the driver always produces or accepts ASCII even though the device itself uses some 
other code. 

5 This word may be omitted if the device is bulk storage. 
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3.1.3 Calling the Driver 


To enable the driver to access the parameter list/ the program must set the first 
word of the driver to an address six bytes less than that of the word containing the 
MEMORY START ADDRESS. It can then directly call the required driver subroutine 
by a normal JSR PC,xxxx call, where xxxx is the address of the driver subroutine. 


As an example, the following position-independent code might appear in a program 
which wishes to read Blocks #100-103 backward from DECtape unit 3 into a buffer 
starting at address BUFFER. 



MOV 

PC,R0 

GET TABLE ADDRESS 


ADD 

#TABLE+12-. ,R0 



MOV 

PC , @R0 

GET AND STORE... 


ADD 

# RETURN- . , @R0 

. . .RETURN ADDRESS 


MOV 

#5404, -(R0) 

SET READ REV. UNIT 3 


MOV 

#-1024. ,-(R0) 

4 BLOCKS REQUIRED 


MOV 

PC , - (R0) 

GET AND STORE 


ADD 

# BUFFER- . , @R0 

. . .BUFFER ADDRESS 


MOV 

#103,- (R0) 

START BLOCK 


CMP 

- (R0) ,- (R0) 

SUBTRACT 4 FROM POINTER 


MOV 

1 R0,DT 

SET DRIVER LINK 


JSR 

PC ,DT .TFR 

GO TO TRANSFER ROUTINE 

WAIT: 

• 


RETURNS HERE WHEN 
. . .TRANSFER UNDER WAY 


. 


RETURNS HERE WHEN 


. 


. . .TRANSFER COMPLETE 

TABLE: 

.WORD 0 


LIST AREA SET 


.WORD 0 
.WORD 0 
.WORD 0 
.WORD 0 
.WORD 0 


... BY ABOVE SEQUENCE 

3.1.4 

User Registers 




During its setup operations for the function requested, the driver assumes that 
Processor Registers 0-5 are available for its use. If their contents are of value, 
the program must save them before the driver is called. 


While servicing intermediate interrupts, the driver may need to save or restore 

its registers. It expects to have two subroutines available for the purpose 

(provided by the Monitor) . It accesses them via addresses in memory locations 

44 and 46 0 . 
o o 

MOV @#44,- (SP) ;0R MOV @#46,- (SP) 

JSR R5,@ (SP) + 
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The driver must also ensure that the start addresses are set into the correct 

locations (44_ and 46„) . 

8 8 

At its final interrupt, the driver saves the contents of Registers 0-5 before 
returning control to the calling program completion return. 

3.1.5 Returns From Driver 

As shown in the example in Section 5-3. 1.3, the driver returns control to the 
calling program immediately after the JSR as soon as it has set the device in 
motion. The program can wait or carry out alternative operations until the driver 
signals completion by returning at the address specified (i.e., RETURN above). 

Prior to this, the program must not attempt to access the data being read in, nor 
refill a buffer being written out. 

The program routine beginning at address RETURN varies according to the device 
being used. In general, the driver has given control to the routine for one of two 
reasons; either the function has been satisfactorily performed, or it cannot be 
carried out due to some hardware failure with which the driver is unable to cope, 
though the program may be able to do so. In the latter case, the driver uses 
the STATUS word in the program list to show the cause: 

Bit 15 *s i indicates that a device or timing failure occurred 
and the driver has not been able to overcome this, 
perhaps after several attempts. 


Bit 14 = 1 shows that the end of the available data has been 
reached . 

The driver places in R0 the contents of its first word as a pointer to the 
parameter table (see Section 5-3. 1.2). 

Possibly, the driver has transferred only some of the data requested. In this 
case, it shows in the RESERVED word of the program list a negative count of the words 
not transferred in addition to setting Bit 14 of the STATUS word. As mentioned in 
the note in Section 5-3. 1.2 , this applies only to non-bulk storage devices. The 
drivers for DECtape or disks 1 always endeavor to complete the full transfer, even 
beyond a parity failure, or they take more drastic action (see Section 5-3. 1.6). 


1 This includes RF11 Disk; although this is basically word-oriented, it is assumed 
to be subdivided into 64-word blocks. 
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It is thus the responsibility of the program RETURN routine to check the informa- 
tion supplied by the driver in order to verify that the transfer was satisfactory 
and to handle the error situations appropriately. 

In addition, the routine must contain -a sequence to take care of the Processor 
Stack, Registers, etc. As noted earlier, the driver takes the completion return 
address after an interrupt and saves Registers f$-5 on the stack above the 
Interrupt Return Address and Status. The program routine should, therefore, contain 
some sequence to restore the processor to its state prior to such interrupt, e.g., 
using the same Restore subroutine illustrated earlier: 

MOV @#46,- (SP) ;CALL REGISTER RESTORE 

JSR R5,@(SP) + 

RTI ; RETURN TO INTERRUPTED PROGRAM 

3.1.6 Irrecoverable Errors 

All hardware errors other than those noted in the previous section cannot normally 
be overcome by the program or by the driver on its behalf. Some of these could be 
due to an operator fault, such as not turning on a paper tape reader or not setting 
the correct unit number on a DECtape transport. Once the operator has rectified 
the problem, the program could continue. Other errors, however, require hardware 
repair or even software repair, e.g., if the program asks for Block 2000 on a device 
having a maximum of 1000. In general, all these errors result in the driver placing 
identifying information on the processor stack and calling IOT to produce a trap 
through location 34g. 

Under DOS/BATCH, the Monitor provides a routine to print a teleprinter message when 
this occurs. In a stand-alone environment, the program using the driver must 
itself contain the routine to handle the trap (unless the user wishes to modify the 
driver error exits before assembly) . The handler format depends upon the program. 
The following format takes advantage of the information supplied by the driver: 



(SP) : 

Return Address 


2 

(SP) : 

Return Status 

Stored by IOT call 

4 

(SP) : 

Error No. Code 

Generally unique to driver 

5 

(SP) : 

Error Type Code: 

1 = Recoverable after Operator Action 
3 = No recovery 

6 

(SP) : 

Additional 

Information 

Such as content of Driver, 

Control Register, Driver Identity, 
etc. 


As a rule, the driver expects a return following the IOT call in the case of recoverable 
errors but contains no provision for an IOT call following a return from irrecoverable 
errors . 
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3.1.7 General Comment 


The source language of each driver has been written for use with DOS/BATCH and 
contains some code which is not accepted by the Paper Tape Software PAL-11R, in 
particular, .TITLE, .GLOBL, and Conditional Assembly directives. Such statements 
should be deleted before the source is used. Similarly, an entry in the driver 
table gives the device name as .RAD50 'DT' to obtain a specifically packed format 
used internally by DOS/BATCH. If the user wishes to keep the name, for instance, 
for identification purposes as discussed in Section 5-3.3, . RAD50 might easily 
be changed to .ASCII without detrimental effect, or it might be replaced with 
.WORD 0. 

3.2 DRIVERS ASSEMBLED SEPARATELY 


Rather than assemble the driver with every program requiring its availability, the 
user may wish to hold it in binary form and attach it to the program only when 
loaded. The only requirement is that the start address of the driver should be 
known or be determinable by the program. 

The example in Section 5-3.1. 2 showed that the Interrupt Servicing routine can be 
accessed through an offset stored in the Driver Tables The same technique can be 
used to call the setup routines, as these also have corresponding offsets in the 
Table, as follows: 


DRIVER+7 

Open 1 

+10 

Transfer 

+11 

Close 1 

+12 

Special Functions 


The problem is the start address. There is the obvious solution of assembling the 
driver at a fixed location so that each program using it can immediately reference 
the location chosen. This ceases to be convenient when the program has to avoid 
the area occupied by the driver. A more general method is to relocate the driver 
as dictated by the program using it, thus taking advantage of the position-independent 
nature of the driver. The Absolute Loader, described in the Paper Tape Software 
Handbook (DEC-ll-XPTSA-A-D) , provides the capability to continue a load from the 
point at which it ended. Using this facility to enter the driver immediately 
following the program, the program might contain the following code to call the 
subroutine to perform the transfer illustrated in Section 5-3. 1.3. 


J If the routine is not provided, these are 0. 
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MOV 

PC,R1 

?GET DRIVER START ADDRESS 


ADD 

#PRGEND- . ,R1 



MOV 

PC,R0 

GET TABLE ADDRESS 


ADD 

#TABLE+12-. ,R0 

AND SET UP AS SHOWN 
...IN SECTION 5-3. 1.3 


CMP 

-<R0) ,-(R0) 

FINAL POINTER ADJUSTMENT 


MOV 

R0 , @R1 

STORE IN DRIVER LINK 


CLR 

-(SP) 

GET BYTE SHOWING. . . 


MOVB 

10 (Rl) ,@SP 

. . .TRANSFER OFFSET 


'add 

(SP) +,Rl 

COMPUTE ADDRESS 


JSR 

PC , @R1 

GO TO DRIVER 

PGREND: 

• END 




This technique can be extended to cover situations in which several drivers are 
used by the same program, provided that it takes account of the size of each 
driver (known because of prior assembly) and that the drivers themselves are always 
loaded in the same order. 

For example, to access the second driver, the above sequence would be modified to: 


MOV 

PC,R1 

;GET DRIVER 1 ADDRESS 

ADD 

# PRGEND- . , Rl 


ADD 

#DVR1SZ ,R1 

; SET TO DRIVER 2 


DVRlSZ=n 
PRGEND : 

.END 


An alternative method may be to use the MACRO Assembler in association with the 
Linker program LINK, both of which are available through the DECUS Library. The 
start address of each driver is identified as a global. Any calling programs need 
merely include a corresponding .GLOBAL statement, e.g., . GLOBL DT. 


3 . 3 DEVICE-INDEPENDENT USAGE 

The drivers are assigned for use in a device- independent environment, i.e., one 
in which a calling program need not know in advance which driver has been associated 
with a table for a particular run. One application of this type might be to allow 
line printer output to be diverted to some other output medium because the line 
printer is not currently available. Another might be to provide a general pro- 
gram to analyze data samples although these on one occasion might come directly 
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from an Analog— to-Digital converter and on another be stored on a DECtape because 
the sampling* rate was too high to allow immediate evaluation. 


Programs of this type should be written to use all the facilities that any 
one device might offer, but not necessarily for each device. For instance, the 
program should ask for start-up procedures because it may sometime use a paper 
tape .punch which provides them, even though it may normally use DECtape which 
does not. As noted in paragraph 5-2. 2.1, the driver table contains an indication 
of its capabilities to handle this situation. The program can thus examine the 
appropriate item before calling the driver to perform some action. As an example, 
the code to request start-up procedures might be (assuming R0 already set to 
List Address) : 


MOV 

#DVRADD,R1 

TSTB 

2 (Rl) 

BPL 

NOOPEN 

MOV 

R0 , @R1 

CLRB 

-(SP) 

MOVB 

7 (Rl) ,@SP 

ADD 

(SP) +,R1 

JSR 

PC,@R1 


;GET DRIVER ADDRESS 
;BIT 7 SHOWS 

; . . .OPEN ROUTINE PRESENT 
; STORE TABLE ADDRESS 
; BUILD ADDRESS 
; ... OF THIS ROUTINE 

; . . .AND GO TO IT 
; FOLLOWED POSSIBLY BY 
f WAIT AND COMPLETION 
; PROCESSING 

; RETURN TO COMMON OPERATION 


NOOPEN j 


Similarly, the indicators show whether the device is capable of performing input 
or output, or both; whether it can handle ASCII or binary data; whether it is a 
bulk storage device capable of supporting a directory structure or is a terminal- 
type device requiring special treatment. Other table entries show the device 
name as identification and the number of words the device might normally expect 
to transfer at a time (in 16-word units) . All of the information can be readily 
examined by the calling program, thus enabling the use of a common call sequence 
for any I/O operation, as illustrated in the example on the following page. 
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MOV 

JSR 

BR 

• WORD 
.WORD 
.WORD 
.WORD 
.WORD 
.WORD 
.WORD 

WAIT: 


#DVRADR , R5 
R5 , IOSUB 
WAIT 
10 
103 

BUFFER 

-256. 

404 

RETURN 

0 


;SET DRIVER START 

;CALL SET UP SUB 

;SKIP TABLE FOLLOWING ON RETURN 

/•TRANSFER REQUIRED 

,-BLOCK NO. 

,‘BUFFER ADDRESS 
;WORD COUNT 
?READ FROM UNIT 1 
;EXIT ON COMPLETION 
; RESERVED 
/•CONTINUE HERE... 


IOSUB: 

MOV 

@SP,R0 


MOV 

R5,R1 


TST 

(Rl) + 


MOV 

@R1 , R1 

ADD 

R0,R1 

CLR 

-(SP) 

MOVB 

@R1,@SP 

ADD 

R0,@SP 

JSR 

PC,@(SP) + 

RTS 

R5 


;PICK UP DRIVER ADDR 
; SET UP POINTER TO LIST 
;BUMP TO COLLECT CONTENT 
/•ROUTINE CHECKS ON DEVICE 
; . . .CAPABILITY USING R1 
; ... TO ACCESS LIST AND 
; . . .R0 THE DRIVER TABLE 
; IF O.K. . . 

;GET ROUTINE OFFSET 

;USE IT TO BUILD 
; . . .ENTRY POINT 

; CALL DRIVER 
;EXIT TO CALLER 


The calling program, or a subroutine of the type just illustrated, may take 
advantage of a feature mentioned earlier; the fact that when a driver is in use, 
its first word is non-zero. The driver itself does not clear this word except 
in special cases shown in the description for the driver concerned. If the pro- 
gram itself always ensures that the first word of the driver is set to zero between 
driver tasks, then this word forms a suitable driver-busy flag. Under DOS, the 
program parameter list is extended to allow additional words to provide linkage 
between lists as a queue in which the list indicated in the driver's first word 
is the first link. 


The preceding paragraphs indicate possible ways of incorporating the available 
drivers into the type of environment for which they were designed. The user should 
carefully read the more detailed description of the driver structure in Chapter 5-4, 
and the individual driver specifications before determining the final form of his 
program. 
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A word of warning is appropriate here. Although most drivers set up an operation 
and then wait for an interrupt to produce a completion state, there are some cases 
in which the driver can finish its required task without an interrupt, e.g., 
"opening" a paper tape reader involves only a check on its status. Moreover, 
where "Special Functions" are concerned, the driver routine may determine from 
the code specified that the function is not applicable to its device, and therefore, 
have nothing to do. In such cases, the driver clears the intermediate return 
address from the processor stack and immediately takes the completion return. 

Special problems can arise, however, if the driver concerned is servicing several 
tasks, any of which can cause a queue for the driver's services under DOS/BATCH. 

To overcome these problems, the driver expects to be able to refer to flags outside 
the scope of the list so far described. This can mean that a program using such 
a driver may also need to extend the list range to cover such possibilities. 
Particular care should be exercised in such cases. 
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PART 5 


CHAPTER 4 

I/O DRIVERS WITHIN THE 
DOS/BATCH OPERATING SYSTEM 

The principal function of an I/O driver is to satisfy a Monitor processing routine's 
requirement for the transfer of a block of data in a standard format to or from 
the device it services. This involves setting up the device hardware registers to 
cause the transfer and gaining control under the interrupt scheme of PDP-11, making 
allowance for peculiar device characters (e.g., conversion to or from ASCII if 
some special code is used) . 


The I/O driver must also include routines for handling device start-up or shut- 
down such as punching leader or trailer, and for making available to the user 
certain special features of the device, such as rewind of magtape. 


4 . 1 DRIVER STRUCTURE 

In order to provide a common interface to the Monitor, all drivers must begin with 
a table of identifying information as follows: 


BUSY FLAG (initially 0) 

FACILITY INDICATOR (expanded below) 

Offset to 

Interrupt Routine* 

Standard Buffer Size 
in 16-word Units. 

Offset to 

OPEN Routine* 

Priority for 

Interrupt Service* 

Offset to 

CLOSE Routine* 

Offset to 

Transfer Routine* 

Space 

Offset to 

Special Functions* 

DEVICE NAME (Packed Radix-50) 


Offsets marked * enable the calling routine 
to indicate the routine required. The offsets 
are considered to be an unsigned value to be 
added to the start address of the driver. This 
may mean that with a 256-word maximum, the 
instruction referenced by the offset is a JMP or BR 
(routine) . 
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The table should be extended as follows if the device is file-structured: 



Unit 0 

Similar Bit-Map 
Pointers for 
Multi-Unit Devices 


The driver routines that set up the transfer and control under the interrupt follow 
the table. 

Bits in the Facility Indicator Word define the device for Monitor reference: 


SPECIAL STRUCTURES 


GENERAL STRUCTURE 


File 

Structured 
Device -i 
DEC tape 
(or simil- 
arly 
reversible) J 
Magtape 


15 14 13 12 11 10 9 8 

t T t H 

Reserved Reserve 


Reserved 


Variable length 
record bit 


▲ n n ▲ a A 


Multi-User 
Output Device 
Input Device 
Binary Device 
ASCII Device 
Contains SPECIAL 
Contains CLOSE 
Contains OPEN 
"Terminal" 

Device 


Multi-unit System 

type devices (i.e., RK disk). 


4.2 MONITOR CALLING 

When a Monitor I/O processing routine needs to call the driver, it first sets up the 
parameters for the driver operation in relevant words of the appropriate DDB 1 , as 
illustrated in the following table. 


1 Dataset Data Block - a 16-word table which provides the main source of communica- 
tion between the Monitor drivers and a particular set of data being processed on 
behalf of a using program. 
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DDB: 


(User Call Address) 
(User Line Address) 


SPECIAL FUNCTION CODE 


DEVICE BLOCK NUMBER 


MEMORY BLOCK ADDRESS 


WORD COUNT (2'S COMPLEMENT) 


TRANSFER FUNCTIONS (expanded below) 


COMPLETION RETURN ADDRESS 


(DRIVER WORD-COUNT RETURN) Set to Zero 


The relevant content of the Transfer Function word is as follows: 


EOF 

or 

EOD TT Echo Control 



Provided that the Facility Indicator in the Driver Table described above shows that 
the driver is able to satisfy the request, according to the direction and mode and 
the service required, the Monitor routine places in Register 1 the relative Byte 
address of the entry in the Driver Table containing the offset to the routine to 
be used (e.g., for the Transfer routine, this would be 10). The Monitor routine 
then calls the Driver Queue Manager, using a JSR PC, S.CDB instruction. 

The Driver Queue Manager refers to the Busy Flag (Word 0 of the driver table) to 
assure that the driver is free to accept the request. If the Busy Flag contains 0, 
the Queue Manager inserts the address of the DDB from Register 0 and jumps to the 
start of the routine in the driver using Register 1 content to evaluate the address 
required. If the driver is already occupied, the new request is placed in a queue 
linking the appropriate DDB's for datasets waiting for the driver's services. It 
is taken from the queue when the driver completes its current task. (This is done 
by a recall to the Queue Manager from the routine just serviced, using JSR PC,S.CDQ) 
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On entry to the Driver Routine, therefore, the address following the Monitor routine 
call remains as the "top" element of the processor stack. It can be used by the 
driver in order to make an immediate return to the Monitor (having initiated the 
function requested) , using RTS PC. It should also be noted that the Monitor 
routine saves register contents if it needs them after the device action. The 
driver may thus freely use the registers for its own operations. 

When the driver has completly satisfied the Monitor request, it should return 
control to the Monitor using the address set into the DDB. On such return. 

Register 0 must be set to contain the address of the DDB just serviced and since 
the return will normally follow an interrupt. Registers 0-5 at the interrupt must be 
stored on top of the stack. 

4 . 3 DRIVER ROUTINES 

4.3.1 TRANSFER 


The sole purpose of the TRANSFER routine is to set the device in motion. The 
information needed to load the hardware registers is available in the DDB, whose 
address is contained in the first word of the driver. Conversion of the stored 
values is the function of the routine. It must also enable the interrupt; however, 
it need not set the interrupt vectors as these are preset by the Monitor when the 
driver is brought into core. After the TRANSFER routine has activated the device, 
the routine returns to the calling processor by an RTS PC instruction. 

4.3.2 Interrupt Servicing 

The form of this routine depends upon the nature of the device. In most drivers 
it falls into two parts, one for handling the termination of a normal transfer and 
the other to deal with reported error conditions. 

For devices which are word or byte-oriented, the routine must provide for indi- 
vidual word or byte transfers, with appropriate treatment of certain characters 
(e.g., TAB or Null) and for their conversion between ASCII or binary and any 
special device coding scheme, until either the word count in the DDB is satisfied 
or an error prevents this. On these devices, the most likely case for such error 
is the detection of the end of the physical medium; the treatment for the error 
varies according to whether the device is providing input or accepting output. 

The calling program usually needs to take action in the former case and the driver 
should merely indicate the error by returning the unexpired portion of the word 
count in DDB Word 7 on exit to the Monitor. Output End of Data requires operator 
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action. To obtain this, the driver should call the Error Diagnostic Print routine 
within the Monitor by: 

DEVNAM, - (SP) ; SHOW DEVICE NAME 

#402,- (SP) ; SHOW DEVICE NOT READY 

; CALL ERROR DIAGNOSTIC PRINT ROUTINE 

On the assumption that the operator will reset the device for further output and 
request continuation, the driver must follow the above sequence with a Branch or 
Jump to resume the transfer. 

Normal transfer handling on blocked devices (or those like RF11 Disk which are 
treated as such) is simpler since the hardware takes care of individual words or 
bytes and the interrupt only occurs on completion. 

Errors that indicate definite hardware malfunctions must generate diagnostic 
messages to the Operator, The only recourse is to start the program over, after 
the malfunction has been corrected. 

There are some errors which the driver can attempt to overcome by restarting the 
transfer. Device parity failure on input is a common example. If one or more 
retries are unsuccessful, the driver should normally allow programmed recovery 
and indicate the error by Bit 15 of DDB word 5. Nevertheless, because the pro- 
gram may try to process the data despite the error, the driver should attempt to 
transfer the whole block requested if this has not already been effected. The 
remaining forms of errors must be processed according to the type of recovery 
deemed desirable. 

Whether the routine uses processor registers for its operation depends on con- 
siderations of the core space saved against the time taken to save the user's 
contents. However, on completion (or error return to the Monitor) , the calling 
routine expects the top of the stack to contain the contents of Registers 0-5 
and Register 0 to be set to the address of the DDB just serviced. The driver 
must, therefore, provide for this. 

4.3.3 OPEN 

This routine need be provided only for those devices that require some hardware 
initialization. It should not normally appear in drivers for devices used in a 
file oriented manner. The presence of the routine must be indicated by Bit 7 
in the driver table Facility Indicator. 


MOV 

MOV 

IOT 
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The OPEN routine may vary according to the transfer direction of the device. For 
output devices, the probable action required is the transmission of appropriate 
data, e.g., CR/LF at a keyboard terminal, form-feed at a printer, or null characters 
as punched leader code, and for this a return interrupt is expected. The OPEN 
routine should then be somewhat similar to the TRANSFER routine in that it sets 
the device going and makes an interim return via RTS PC, waiting until completion 
of the whole transmission before taking the final return address in the DDB. 

An input OPEN may consist of just a check .on the readiness of the device to provide 
data when requested. In this case, the desired function can be effected without any 
interrupt wait. The routine should, therefore, take the completion return immediately. 
Nevertheless, it must ensure that the saved PC value on top of the stack from the call 
to S.CDB is appropriately removed before exit. In the case of drivers which can service 
only one dataset at a time (i.e.. Bit 0 of their Facility Pattern word is set to 0) 
and can never be queued, a TST (SP)+ instruction can effect this. However, a multi- 
user driver must allow for the possibility that it may be recalled to perform some 
new task waiting in a queue. This condition exists if the byte at DDB- 3 is non-zero. 

In this case, the driver must simulate the interrupt expected by the completion 
process. This is accomplished by inserting a PS word on the stack above the return 
address supplied by the JSR of the Open request. A possible sequence for the 
interrupt simulation is illustrated below. 



MOV 

DRIVER, R0 

f PICK UP DDB ADDRESS 


MOV 

(SP) + ,R5 

;SAVE INTERIM RETURN 


TSTB 

-3 (R0) 

;COME FROM QUEUE? 


BEQ 

EXIT 



MOV 

@#177776, -(SP) 

; IF SO, STORE STATUS 


MOV 

R5,-(SP) 

; . . . & RETURN 


SUB 

#14, SP 

; DUMMY SAVE REGS 

EXIT: 

JMP 

@10 (R0) 


4.3.4 

CLOSE 




The CLOSE routine is like the OPEN routine, in that it should provide for the 
possibility of some form of hardware shut-down, such as the punching of trailer code 
and that it is not necessary for file-structured devices. Moreover, it is likely 
to be a requirement for output devices only. If it is provided. Driver Table 
Facility Indicator (Bit 6) must be set. 
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Again, the probable form is initialization of the hardware action required/ with 
immediate return via RTS PC and eventual completion return via the DDB-stored 
address. 

4.3.5 SPECIAL 


This routine may be included if either the device itself contains the hardware to 
perform some special function or there is a need for software simulation of each 
hardware on other devices, e.g., tape rewind; it should not be provided otherwise. 

Its presence must be indicated by Bit 5 of the Facility Indicator. 

The function itself is stored by the Monitor as a code in the DDB. When called, 
the driver routine must determine whether such function is appropriate in its case. 

If not, the completion return should be taken immediately with prior stack clearance, 
as discussed under OPEN. For a recognized function, the necessary routine must be 
provided. Its exit method depends upon the necessity for an interrupt wait. 

4.4 DRIVERS FOR TERMINALS 

The rate of input from terminal devices normally reflects the typing skill of the 
operator. For both input and output, the amount of data to be transferred on each 
occasion may be a varying length, i.e., a line rather than a block of standard size. 
Furthermore, echoing input may conflict with interrupting output. As a result, 
drivers for such devices demand special treatment. 

Normal output operation, i.e., .WRITE by the program, is handled by the Monitor 
Processor. On recognizing that the device being used is a terminal, as shown by Bit 
8 of the facility indicator, this routine always causes a driver transfer at the end 
of the user line, even though the internal buffer has not been filled. The driver, 
however, is given the whole of a standard buffer, padded as necessary with nulls. 
Provided the driver can ignore these, the effect is the suppression of trailing nulls 

Input control remains the driver's responsibility since overcoming the rate problem 
requires circular buffering within the driver. This circular buffering feature 
allows the user type-ahead facilities. A subsequent input request may then be 
satisfied by data already in core. If the data is sufficient to fill the Monitor 
buffer, the driver awaits the next request before further transfer. If this is 
insufficient, the driver should operate as any other device and use subsequent 
interrupts to satisfy the Monitor's requests. Since the driver must stop any trans- 
fer at the end of a line in normal operation, in order to allow the Monitor to con- 
tinue, the driver must simulate the filling of the buffer by null padding. If the 
user requests .TRAN's which are not line oriented, the buffer size varies from the 
standard and the driver assumes the program requires a complete buffer before 
return. 
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PART 5 

CHAPTER 5 

SAMPLE LINE PRINTER DRIVER LISTING 


The following is a sample listing of a DOS/BATCH Device Driver. The actual driver 
is the LP11 Line Printer Driver (for device name LP : ) . 


1 f DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASSACHUSETTS 01 


2 

«» 


> 

| 

COPYRIGHT, i»73 

0 

4 


, 

1 

DIGITAL 

EQUIPMENT CORPORATION ASSUMES No RESPONSIBILITY 

5 


1 

FOR THE 

USE OR RELIABILITY OF ITS SOFTWARE ON EQUIPMENT 

6 

7 

6 



WHICH IS NOT SUPPLIED 8Y DIGITAL EQUIPMENT CORPORATION, 


t 

t 

• 

VERSION 

NUMBER! V13.01 

9 

10 


f 

t 

DATED! 

MARCH 5, 1973 

1 1 

12 


t 

1 

DEVICE 

DRIVER FOR THE LPU/LS11 LINE PRINTER (3) 

IS 

14 


t 

f 

DRIVER 

PARAMETERIZATION SYMBOLS 

15 

16 

17 

ie 

19 


t 

l 

LPTYP 

• IF 

L P 1 1 # LSI 1 , WIDTH, SPACES, SPREAD 

NOF, LPTYP ;LPTYP=0 if LP11 

0 ; LPTYP*=1 if LS11 

20 

21 

22 

23 

000001 

LP1 1 

, ENDC 
.IF 

•TITLE 

• 

; DEFAULT IS 0 

EQ, LPTYP 

DV.LP0 

1 

24 

000012 

SKIP2 

• 

12 

25 

26 

27 

28 


LS11 

.IFF 

.IF 

.TITLE 

• 

eq,<lptyp-i> 

dv,lp*. 

1 

29 


SPREAD 

• 

1 

30 


SK1P2 

i 

13 

31 

32 



• IFF 
•MERROR 

IUNSUPPORTED LINE PRINTER 

33 

34 

35 

36 

37 


WIDTH 

• ENDC 
.ENDC 

, IFNDF 

p 

width 

80, ! 80, COLUMN PRINTER DEFAULT 

38 

39 

40 

000000 

R0 

. ENOC 

• 

X0 

41 

000001 

Rt 

p 

XI 

42 

000002 

R2 

a 

X2 

43 

000003 

R3 

p 

X3 

44 

000004 

R4 

« 

X4 

45 

000005 

R5 

• 

X5 

46 

000006 

SP 


X6 

47 

000007 

PC 


X7 

48 

49 

000402 

A002 


402 f DIAGNOSTIC MESSAGE CODE 

50 

51 

000044 

S.KSAv 


44 f REGISTER SAVE (MONITOR SUPPORT 
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DV 

• UP0 

MACRO V06.03 09 

*JAN»74 

12155 PAGE 5 


1 

2 




* GUOBU 

UP 


3 

A 




• IDENT 

713,01/ 


5 

it 



9 

008-11 

DEVICE DRIVER 1 8 

STANDARDIZED INTERFACE 

7 i 

000000 

000000 

UPI 

• WORD 

0 

9 USER’S DOB POINTER 

0 




• IFOF 

UStt&SPREAD 


9 




• BYTE 

362 

t faciuities indicator 

10 




• ENOC 



11 




• ifndf 

USlt&SPREAD 


12 

00002 

322 


• BYTE 

322 

9 FACIUITIES indicator 

13 




• ENOC 



14 

00003 

000 


• BYTE 

0 

9 SPEC I AU structures, none 

19 

00004 

003 


• BYTE 

«<WlDTH*37>/40* > STANDARD BUFFER SIZE 

16 

00005 

110 


• BYTE 

up.int-up 

9 interrupt entry offset 

17 

00006 

200 


• BYTE 

200 

9 INTERRUPT PRIORITY 4 ‘ 

18 

00007 

036 


• BYTE 

UP.OPN-UP 

9 OPEN ENTRY OFFSET 

19 

00010 

060 


• BYTE 

UP.TRN-UP 

9 TRAN ENTRY OFFSET 

20 

00011 

036 


• BYTE 

up.cu-s-up 

9 cuose entry offset 

21 




• IF 

EOiUPTYP 


22 

00012 

000 


• BYTE 

0 


23 




• IFF 



24 




• BYTE 

UP.SPC-UP 

9 SPECIAU ENTRY OFFSET 

29 




• ENOC 



26 

00013 

000 


• BYTE 

0 

9 SPARE 

27 

00014 

046600 

UP.NAM1 

• RAD50 

/UP' 

9 DEVICE DRIVER'S NAME 

26 







29 


000200 

UP* TRP 

■ 

200 

9 INTERRUPT VECTOR'S ADDRESS 

30 


177914 

UPtCSR 

ff 

177514 

9 CQMMANO/STATUS register 

31 

32 

33 


177516 

UP.DBK 

• 

177516 

9 DATA BUFFER REGISTER 

00016 

000120 

UP.8IZJ 

• WORD 

WIDTH 

9 THIS WORD IS SET BY THE INITJA 

34 

00020 

000133 

UPPCA8I 

• WORD 

133 

9 SET TO THE HIGHER PRINT UIMIT 

39 

00022 

000000 

ovpknti 

• WORD 

0 

9 SET TO TRUE WHEN OVER PRINTING 

36 

00024 

000000 

LP.LlNI 

• WORD 

0 

9 AUREADY SENT (CHARACTERS) 

37 

00026 

000000 

UP.BKS* 

• WORD 

0 

9 buank POSITIONS counter 

30 

00030 

000000 

LP.TCTI 

• WORD 

0 

I TRANSFER CHARACTER COUNT 

39 

40 

41 

00032 

000000 

UP • 040 | 

• WORD 

0 

9 BUFFER AODRESS POINTER 

00034 


UP.TQFI 



9 COMMAND DEVICE TO TOP-OF-FORM 

42 




• IFDF 

usu 


43 




• BYTE 

21 

9 CQMMANO device to qn-uine 

44 




• ENQC 



45 

00034 

015 


• BYTE 

15,14 

9 CR, FF 


00035 

014 





46 




• EVEN 



47 




• IFDF 

USlt&SPREAD 


40 



UP.FUBI 

• WORD 

0 

9 character euongation fuag 

49 




• ENOC 



50 







61 


000040 

UP.UQW 

i 

40 

9 PRINTABIUITY, U0WER UIMIT 
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1 


2 


; 

OPfcN PROCESSOR 


3 000036 


UP.OPNI 




4 


i 

CLOSE PROCESSOR 


5 000036 


LP«CL3J 




6 000036 

004767 


J SR 

PC, L?. STS 

i simulate interrupt 


000454 





7 000042 

062/01 


ADD 

#lp.top«.,ri 

f Ri * PC (BY LP # STS) 


177772 





8 000046 

010167 


MOV 

RIiLF.BAO 

I internal buffer’s address 


177760 





9 



• IFDF 

LSI! 


10 



MOV 

#-3,LP,TCT 

f INITIALIZE TRANSFER COUNT 

11 



* ENOC 



12 



* IP NOP 

LSI 1 


13 00032 

010267 


MOV 

R2»LP,TCT 

f R2 ■ -2 (BY LP.STS) 


177752 





14 



,ENOC 



15 



• IFDF 

LSI 14SPR6A0 


16 



CLR 

LP.FLG 

t INITIALIZE ELONGATION FLAG 

17 



• ENOC 



16 00036 

000414 


8R 

LP.INT 

; OISPATCH internal buffer 

19 

20 



• I F 0 F 

LS1145PREA0 


< 1 

22 


t 

SPECIAL 

PKQCtSSQN 


23 


LP.SPCI 




24 



MOV 

2(R0) i R1 

f Rl * FUNCTION block’s address 

25 



CMPB 

ni f c«n 

} LINE ELONGATION FUNCTION ? 

26 



BNE 

LP.S00 

; NO# IGNORE 

27 



MOV 

2CR13 , LP.FLG 

; enable/disable elongation 

28 


LP.S001 

J MR 

P14CR0) 

} exit via completion return 

29 



• ENOC 



30 






31 


I 

TRAN PROCESSOR 


32 00050 


LP.TNNI 




33 00060 

004767 


JSR 

PC,LP,ST3 

i simulate an interrupt 


000432 





34 00064 

016700 


MOV 

LP » R0 

1 R0 ■ USER’S DOB address 


177710 





35 0.0070 

016067 


MOV 

6 CR0i i LP • B AO 

1 RETAIN BUFFER’S AOORESS 


000006 






177734 





36 00076 

016067 


MOV 

10(R0DrLP,TCT 

1 RETAIN DOB’S BYTE COUNT 


000010 






177724 




' 

37 00104 

006367 


ASL 

LP.TCT 

t 


177720 
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1 

2 ? INTERRUPT PROCESSOR CVlA INTERRUPT VECTOR AT 200) 

3 000110 UP * I NT * 


4 

000110 

042737 

00*0100 

177514 


6IC 

#100#*#UP.CSR 

f oisabue interrupt 

5 

000116 

002002 


BGE 

UP. 10 

; segregate errors 

6 

000120 

000167 

000354 


JMP 

UP. ERR 

i ENTER ERROR PROCESSOR 

7 

000124 

005767 

177700 

UP. 101 

TST 

UP.TCT 

* any CHARACTERS remaining ? 

8 

000130 

001452 


BEG 

UP.OUNE 

1 NO. UINE compueted 

9 

000132 

010446 


NOV 

R4. •, (SP) 

1 SAVE REGISTERS 

10 

00134 

010346 


MOV 

R3. • (SP) 


11 

00136 

010246 


MOV 

R2 . «* (3P) 


12 

00140 

010146 


MOV 

R 1 . » (SP) 


13 

00142 

016704 

177660 


MOV 

UP.BKS.R4 

t R4 * BUANK COUNTER 

14 

00146 

016703 

177652 


MOV 

UP.UIN.R3 

t R3 * PRINT POSITION 

15 

00152 

016702 


MOV 

UP.BAD.R2 

f R2 9 BUFFER POINTER (ADDRESS) 



177654 


/ 



16 

00136 

112201 

UP, 100* 

MQVB 

(R2)+.R1 

f *** ACCESS CHARACTER *** 

17 

00160 

001426 


BEQ 

UP.ONp 

1 NUUU (0) IGNORED 

18 

00162 

120127 

000040 

UP. 1311 

CMP8 

Rl.#UP,UOw 

f PRINTABIUITY check 

19 

00166 

002442 


BUT 

UP .110 

t EXCEEDS COWER UIMIT 

20 




. IP OF 

SPACES 


21 




BGT 

UP. 102 

i vauid character, so far 

22 




INC 

R4 

f BUANK (40) ISOUATED, COUNT 

23 




BR 

UP.TRT 

f ACCESS NEXT CHARACTER 

24 




• ENOC 



25 

00170 

120167 

177624 

UP. 102* 

CMPfcj 

Rl.UPPCAS 

f PRINTABIUITY CHECK 

28 

00174 

002111 


BGE 

UP, Ii8 

t EXCEEDS UPPER UIMIT 

27 

00176 

005203 

UP. 103* 

INC 

R3 

f PRINTER'S WIDTH EXCEEDED ? 

28 

00200 

003016 


BGT 

UP.DNR 

1 YES, DO NOT PRINT 

29 

00202 

032737 

UP. 104* 

BIT 

#100200, MUP.CSR* ACCESS ERROR/READY STATUS 



100200 

177514 





30 

00210 

100331 


BMI 

UP. 122 

* ERROR INDICATION 

31 

00212 

001520 


BEG 

UP. 120 

f NOT READY INDICATION 

32 

00214 

005304 


DEC 

R4 

t DECREMENT BUANK COUNTER 

33 

00216 

100404 


BMI 

UP. 105 

1 NOT PROCESSING BUANKS 

34 

00220 

112737 

000040 

177316 


MQVB 

#40,P#UP.DBR 

f BUANK/HTAB EXPANSION PERFORMED 

35 

00226 

000763 


BR 

UP. 103 

f CONTINUE PENDING COMPUETIDN 

36 

00230 

110137 

177616 

UP. 103* 

MQV8 

R1 r A#UP,UBR 

1 *** PRINT CHARACTER *** 

37 

00234 

005004 

UP. 1061 

CUR 

R4 

1 INSURE NO BUANKS PENDING 

38 

00236 


UP.ONP* 




39 

00236 

005267 

177566 

UP.TRT* 

INC 

UP.TCT 

f INCREMENT BUFFER'S CHARACTER 

40 






1 COUNTER. ANY MORE ? 

41 

00242 

001345 


8NE 

UP. 100 

* YES 
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2 

3 


t 

1 


LINE COMPLETED 

4 00B244 

105737 

177514 


TSTB 

MLP.CSR 

5 000250 

100103 


BPL 

LP.I21 

6 000252 

004567 

000260 

LP.ONtl 

J SR 

H5 # LP.SET 

7 000258 

013746 

000044 

lp.doni 

MOV 

##$,KSAV t ■» (SP) 

8 000252 

004536 


J SR 

R5,#($P)+ 

9 000254 

016700 

177510 


MOV 

LP»Htf 

10 00270 

11 

000170 

000014 


JMP 

#14(R0) 

12 00274 

120127 

000011 

LP.I10I 

CMPd 

Ri,«U 

13 00300 

14 

15 

15 

001010 

t 

l 

t 

BNE 

LP* 1 13 

HORIZONTAL TAB 

17 00302 

18 

19 

20 

21 

22 

016746 

177510 


MOV 

, IFOF 
TST 

BEQ 

ASR 
• ENOC 

LP ♦ SlZ » • (SP) 

LSU&SPRtAO 

lp.flg 

LP# I 1 1 
(SP) 

23 00306 

24 

25 

25 

27 

28 

060316 

LP * 1 1 1 1 

ADO 
• IFOF 
BGE 

CLR 

BR 

, E N Q C 

R3 » (SP) 
LSUSSPREAD 

LP# 1 12 

lp.tct 

lp.one 

29 00310 

060416 

LP.I12I 

AQQ 

R4, (SP) 

30 00312 

052716 

177770 


BIS 

#1 77770# (SP) 

31 00316 

32 

102604 


SUB 

(SP) t,R4 

33 00320 

34 

000746 


BR 

LP.TRT 


I DEVICE BUSY ? 
f YES 

I RESTORE TEMPORARIES 
f SAVE REGISTERS 
t 

I R0 n USER’S DOB ADORESS 
I EXIT VIA COMPLETION RETURN 


horizontal tab an ? 
no 


MULATIQN via BLANKS 


PRINTER'S MAX WIDTH 


ELONGATION ? 

NO 

(PRINTER'S WIDTH) 72 

• PRINT POSITION 

NOT EXCEEDED PRINTER'S WIDTH 
ELONGATION LINE TERMINATION 
EXIT 

♦ blank COUNTER 

( MODULO 8 ) - 8 

4- BLANK COUNTER 
* BLANK COUNTER 

access next character 



1 

000322 

120127 

000016 

UP. 113: 

cmpb 

R 1 , #1 5 

) carriage-return c i 55 ? 

2 

000326 

003010 


BGT 

UP. 114 

f no, above 

3 

000330 

001014 


BNE 

UP. 115 

1 no, below 

4 

000332 

005767 

177464 


T ST 

OVPRNT 

t PRINT the CARRIAGE-RETURN 7 

5 

000336 

001021 


BNE 

up. H e 

1 YES 

6 

000340 

016703 

177452 


NOV 

LP, SIZ, R3 

f R3 « -( PRINTER'S WIDTH) 

7 

000344 

005403 


NEG 

R3 

f 

8 




• IFOF 

USlliSPRtAD 


9 




TST 

up. fug 

t euongatiun enabueo 7 

10 




BEG 

UP • I AX 

; no 

11 




ASR 

R3 

f HAUVE PRINTER'S WIDTH 

12 




NOV 

R3,UP,FUG 

) RE-INITIAUIZE THE FUAG 

13 




.ENOC 



14 

00346 


lp.ixx: 




13 

00346 

000732 


BR 

UP. 106 

t SUPPRESS CARRIAGE-RETURN 

18 

00330 


UP. 114: 

• IFOF 

LSU&SPREAD 


17 




TST 

UP, FUG 


18 




BEQ 

up. I y y 


19 




CMPB 

Rl ,#16 


20 




BEQ 

UP. 104 


21 



LP.IYy: 




22 




• ENOC 



23 

00350 

120127 

000022 


c mpq 

R 1 , #22 


24 

00354 

001016 


BNE 

UP* I 17 

t NO 

23 

00356 

012701 

000012 


MOV 

#3KIP2,R1 

1 SUBSTITUTE APPROPRIATE CHAR 

26 

00362 

120127 

000012 

up. H a: 

CMPB 

Rl,#l2 

1 UINEFEED (12) 7 

27 

00366 

002411 


BUT 

UP, 117 

; NO, BELOW 

28 

00370 

001404 


BEQ 

UP, 116 

; YES 

29 

00372 

120127 

000013 


CMP8 

R 1 p #13 

1 VERTICAL tab (13) 7 

30 

00376 

001717 


BEG 

UP.DNP 

} YES, IGNORE IT l 

31 

00400 

000400 


BP 

UP, 116 

f NO, FORMFEED (14) ISOLATED 

32 

00402 


up. H6: 




33 

00402 

016703 

177410 


MOV 

UP.8IZ,H3 

1 R3 » -( PRINTER'S WIDTH ) 

34 

00406 

005403 


NEG 

R3 


35 




.IFOF 

LSI 1 ^SPREAD 


36 




TST 

UP. fug 

) ELONGATION enabled 7 

37 




BEG 

UP, 104 

f NO, PRINT CHARACTER 

38 




ASR 

R3 

f HALVE PRINTER'S WJOTH 

39 




NOV 

R3, UP. FUG 

t RE-INITIAUIZE THE FLAG 

40 




.ENOC 



41 

00410 

000674 


BR 

UP, 104 

f PRINT THE character 
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1 000412 

012701 

UP. 1171 

MOV 



000040 



2 000416 

000667 


BR 

3 000420 

120127 

UP. 118* 

CMP8 



000172 



4 1 

Ci 

300424 

003003 

f 

BGT 

0 

6 



9 

i 


7 



t 


8 i 

000426 

042701 


BIC 



000040 



9 i 

000432 

000661 


8R 

10 

00434 

120127 

UP. 119* 

CMPS 



000177 



11 

00440 

001676 


BEQ 

12 

004«2 

126727 


CMPB 



177352 





000137 



13 

00450 

101252 


BHI 

14 

00452 

000757 


BR 

15 





16 

00454 

005303 

UP. 1201 

DEC 

17 

00456 

005302 


DEC 

18 

00480 

004567 

UP.X21* 

JSR 



000052 



19 

00454 

052737 


BIS 



000100 





177514 



20 

00472 

000002 


RT1 

21 





22 

00474 

005303 

UP. 1221 

OEC 

23 

00476 

005302 


DEC 

24 

00500 

016746 

UP.tRKI 

MOV 



177310 



25 

00504 

012746 


MOV 



000402 



26 

00510 

000004 


IOT 

27 

00512 

000167 


JMP 


177372 


840, Rl 

j UNPRINTABLE, buank substitute 

UP. 103 

Rl, 8172 

I PRINT A BUANK 
f UOWER CASE ALPHABET 7 

UP. 119 

f EXCEEDS 

LOWER CASE TO UPPER CASE CONVERSION PERFORMED 

840, Hi 

f CONVERSION PERFORMED 

UP. 103 

R1 ,8177 

| PRINT CHARACTER 
; RUBQUT (177) 7 

UP.QNP 

UPPCAS » 8l 37 

! YES, IGNORED 

1 UPPER CASE PERMITTED 7 

UP. 103 

UP. U7 

f YES, PRINT CHARACTER 
; unprintable, blank SUBSTITUTE 

R3 

R2 

R5 # UP • SET 

f BACKUP PRINT POSITION 

1 BACKUP BUFFER POSITION 

1 RESTORE TEMPORARIES 

8100» MUP.CSR 

f enable interrupt 


f EXIT FROM INTERRUPT 

R3 

R2 

UP,NAm,-CSP) 

t BACKUP PRINT POSITION 

1 BACKUP BUFFER POSITION 

J DEVICE DRIVER'S MNEMONIC 

8A002,*(SP) 

1 MESSAGE CODE 

up.int 

f TRY AGAIN 
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1 1 

2 t * interrupt simulator 

3 I 


4 000516 

012801 

LP.STSl 

MOV 

CSPl-SRl 

1 RETURN PC 

5 0006)20 

011546 


MOV 

(SP) r -CSP) 

i OLD PC 

6 000522 

005002 


CLP 

R2 

t ADDRESS PS 02) 

7 000524 

014266 

000002 


MOV 

•CR2),2C3P) 

f OLD STATUS 

8 000530 

013712 


MOV 

MLPtTRP + 2, CR2) 1 NEW STATUS 

9 000534 

10 

11 00536 

000202 

010107 


MOV 

R1,PC 

t RETURN 

010467 

177264 

LP.SET1 

MQV 

R4,lP,BK3 

f RESTORE TEMPORARIES 


12 00542 

010367 

177256 


MOV 

R3,LM.LIN 

t 

13 00546 

010267 

177260 


MOV 

R2,LP,BAU 

1 

14 00552 

016804 

000010 


MOV 

10 (SP) # R4 

t RESTORE REGISTER 4 

15 00556 

012866 

000006 


MOV 

(SP5S6C3P) 

f RETAIN RETURN ADDRESS 

16 00582 

012601 


MOV 

CSP)*,R1 

f RESTORE REGISTERS 

17 00554 

012602 


MOV 

(3P)*,R2 

1 

18 00586 

012003 


MOV 

(SP)*,R3 

t 

19 00570 

000205 


RTS 

R5 

t EXIT SUBROUTINE 

20 

000001 ' 


.ENQ 
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SYMBOL TABLE 


A002 » 

000402 

BFSHFT* 

010000 

blank p 

000040 

8SLSH • 

000134 

CR * 

000015 

DOBAORi 

000006 

DOBBLK* 

000004 

DDBCNTs 

000010 

ODBCRT* 

000014 

00B0VA# 

177776 

DOBSTSi 

000012 

DDBUL A» 

000002 

DOBUNT* 

000013 

DlTBFSi 

000004 

DITBMPi 

000016 

D1T8SY* 

000000 

DITFAC* 

000002 

01TINT » 

000005 

DITMFD* 

000014 

DITNAMP 

000012 

DIIQPNp 

000007 

OITPRI* 

000006 

OlTSPFi 

000011 

DITXFRp 

000010 

EMTINT* 

000006 

EMTRET* 

000014 

EMTVAL* 

104000 

EMTVEC* 

000030 

FTCOM ■ 

000001 

FTOQS « 

000001 

FTMUQ * 

000001 

FTRPG ■ 

000001 

FTRP03* 

000001 

F00 1 » 

001401 

F002 * 

001402 

F 003 p 

001403 

F 005 * 

001405 

F007 i 

001407 

F01 1 ■ 

001411 

F012 * 

001412 

F017 p 

001417 

F024 p 

001424 

F042 « 

001442 

F050 « 

001450 

F052 » 

001452 

KSBSIZ* 

000400 

LF * 

000012 

LP 

000000KG 

lptyp » 

000000 

LP# BAO 

000032R 

LP.BKS 

000026R 

LP • CLS 

000036R 

LP.CSR* 

177514 

LP.DBRp 

177516 

LP.QNfc 

000252R 

LP.ONP 

000256R 

LP.OON 

000256R 

LP • ERR 

000500R 

LP.1NT 

0001 1 0 R 

LP.IXX 

000346R 

LP# 10 

000124K 

LP# 100 

000156R 

LP# 101 

000162R 

LP • 102 

000170R 

LP # 103 

0001/6R 

LP • 104 

000202R 

LP# 105 

000230R 

LP. 106 

000234R 

LP.1I0 

000274R 

LP# 1 1 1 

000306R 

LP# I 1 2 

000310R 

LP# I 1 3 

000322R 

LP# 1 1 4 

000350R 

LP.I15 

000362R 

LP.IX6 

000402R 

LP# 1 17 

000412R 

LP# 1 1 8 

0 0 0 4 2 0 R 

LP.I19 

000434R 

LP# 120 

000454R 

LP# 121 

000460R 

LP# 122 

00047 4R 

LP.LIN 

000024R 

LP , LOR * 

000040 

LP.NAM 

000014R 

LP.OPN 

000036R 

LP « SET 

000536R 

LP#S1Z 

000016R 

LP.STS 

000516R 

LP.TCT 

000050R 

LP# TOF 

000034R 

LP.TRN 

000060R 

LP.TRP* 

000200 

LP.TRT 

000236R 

LP 1 1 • 

000001 

MSBSIZ* 

001000 

OVL006P 

000002 

OVL01B* 

000006 

OVPRNT 

000022R 

OV 1061 p 

000012 

OV2061* 

000012 

PATSIZ* 

000030 

PRI4 ■ 

000200 

PRX7 « 

000340 

PS « 

177776 

PSPRXQ« 

177437 

RPBIT * 

004000 

RP02SZ" 

000020 

RUBOUTp 

000177 

SKIP2 ■ 

000012 

SMB31ZP 

000040 

STMASKp 

107070 

S,RSAV« 

000044 

TABCH ■ 

000011 

UPPCAS 

000020R 

V • COB « 

000050 

V.COQ » 

000052 

V.GTB p 

000054 

V,RL« « 

000056 

V.RRES* 

000046 

V.RSAVp 

000044 

V.SVT » 

000040 

V.X1T • 

000042 

WIDTH « 

000120 

XFTCOM* 

000000 

XFTOOSi 

000000 

XFTMUOp 

000000 

XFTRPG" 

000000 

SSPASSp 

000000 



• abs. 

000000 

000 





000572 001 
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CROSS REFERENCE TA#U S-l 


A002 

1 • 

834 

4- 494 

BFSHFT 

1- 

1024 


BUANK 

1- 

1234 


BSLSH 

1-1244 


CR 

1- 

1204 


OOBAOR 

1- 

544 


DDBBUK 

1- 

534 


ODBCNT 

1- 

554 


DOBCRT 

1- 

584 


DOBDVA 

1- 

514 

1-1064 

DQBSTS 

1- 

564 


ODBULA 

1- 

524 

1-1054 

DDBUNT 

l- 

574 


QIT8F5 

1- 

364 


DIT8MP 

1- 

454 


OITBSY 

1- 

344 


OXTFAC 

1- 

354 


oitint 

1- 

384 


OITMFD 

1- 

444 


DUNAM 

1- 

434 


oitoPn 

l- 

404 


DITPRI 

1- 

394 


DITSFF 

1- 

424 


DITXFR 

1- 

414 


EMTINT 

1- 

634 


EMTRfcT 

1- 

624 


EMTVAD 

1- 

614 


EMTVfeC 

1* 

644 


FTCOM 

3- 

64 


FTOQS 

3- 

124 


FTMUO 

3- 

84 


FTRPG 

3- 

104 


FTRP03 

3- 

164 


F00 1 

1- 

814 


F002 

1- 

804 


F003 

1- 

854 


’ F005 

1- 

824 


F007 

1- 

884 


F0U 

1- 

864 


F012 

1- 

874 


F017 

1- 

894 


F024 

1- 

91# 


F042 

1- 

924 


F0b0 

1- 

844 


F052 

1- 

904 


KSBSIZ 

2-400# 


CF 

1-: 

1214 


UP 

5- 

24 

5- 74 


8 m 

9 


LPTYP 

4- 

18 

4- 21 

UP • BAD 

5- 

394 

6« 8# 

LP.BKS 

5* 

374 

7m 13 

UP.CUS 

5- 

20 

Urn 54 

IP.CSR 

6- 

304 

/- 44 

LP.DBR 

5- 

314 

7- 344 

LP.DNfc 

8* 

64 


UP • QNP 

7- 

17 

7- 28 

UP • DON 

7- 

8 

8- 74 


10- 25 


5- 

16 

ttiv 

18 

5- 

19 

5- 

6- 

11* 

21 

354 

UP 

7- 

15 

11** 

13* 

4ft 

7 — 

7- 

29 

364 

8. 

4 

10- 

194 

7- 

384 

9 * 

30 

10- 

11 


5- 20 


6- 34 
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CROSS K£Ffc KfcNCfc 

TABLt S- 

2 


UP. ERR 

7- 

6 

10. 

24# 



LP.INT 

5* 

16 

6. 

18 

7* 

3# 

UP.IXX 

9- 

14# 





IP. 10 

7« 

5 

7. 

7# 



UP. 100 

7" 

16# 

7. 

41 



UP. 101 

7« 

16# 





UP. 102 

7- 

25# 





UP. 103 

7. 

27# 

7- 

35 

10. 

2 

UP. 104 

7- 

29# 

9. 

41 



UP, 105 

7- 

33 

7. 

36# 



UP. 106 

7" 

37# 

9. 

15 



UP. 110 

7- 

19 

8. 

12# 



UP. Ill 

8* 

‘ 23# 





UP. 112 

8- 

29# 





UP, 113 

8- 

13 

9* 

1# 



UP, 114 

9" 

2 

9. 

16# 



UP. 115 

9* 

3 

9- 

26# 



UP, 116 

9* 

5 

9. 

28 

9- 

31 

UP, 117 

9. 

24 

9m 

27 

10" 

1# 

UP. 118 

7* 

26 

10* 

3# 



UP, 119 

10- 

4 

10* 

10# 



UP. 120 

7- 

31 

10- 

16# 



UP, 121 

8- 

5 

10. 

18# 



UP. 122 

7- 

30 

10. 

22# 



UP.UIN 

8- 

36# 

7- 

14 

11* 

124 

UP.UOW 

5- 

81# 

7« 

18 



UP, NAM 

5- 

27# 

10* 

24 



UP, OPN 

0- 

16 

6* 

3# 



UP. SET 

y. 

6 

10. 

18 

1 1 - 

11# 

UP.SIZ 

8- 

33# 

8* 

17 

9* 

6 

UP, STS 

t>. 

6 

6. 

33 

11- 

4# 

up.tct 

5- 

38# 

6* 

134 

5 . 

364 

UP. TUP 

5- 

41# 

6. 

7 



UP.TRN 

5- 

19 

b * 

32# 



UP. TKP 

5- 

29# 

li- 

8 



up .m 

7- 

39# 

ft* 

33 



UP 11 

4- 

23# 





usu 

8- 

8 

8- 

11 

5* 

42 


6- 

20 

8. 

18 

8- 

24 

MSBSIZ 

2- 

159# 





OVU006 

1* 

108# 





OVU016 

1- 

107# 





OVPWNT 

8" 

35# 

9- 

4 



OV1061 

1" 

109# 





OV2061 

1- 

110# 





PATSIZ 

1- 

116# 





PC 

1" 

14# 

4 . 

47# 

6" 

64 

PR14 

1- 

74# 





PRI7 

1- 

75# 





PS 

1- 

72# 





PSPRIO 

1- 

73# 





RP81T 

1- 

103# 





RP02SZ 

1- 

104# 





RUBOUT 

1- 

125# 





R0 

1- 

7# 

4. 

40# 

6 — 

344 

R 1 

1- 

8# 

4 . 

41# 

6- 

74 


7- 

25 

7 . 

36 

8- 

12 


9- 

29 

10- 

14 

10- 

3 


10. 2 7 


10. 9 10. 13 


9. 32# 
10. 14 


9- 33 

6. 374 7* 7 7- 39# 


8- 47 8- 9 6*< 12 6- 15 

9- a 9* 16 9« 35 


6. 33# U. 9# 


6- 

38 

6- 

36 

8- 

94 

8- 

10 

6- 

8 

7 . 

12 

7 - 

164 

7 — 

18 

9 — 

1 

9- 

23 

9- 

254 

9 — 

26 

10- 

8f 

10- 

10 

1 1 - 

4# 

1 1- 

9 
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CROSS REFERENCE TABU S-3 



1 l* 

16# 





R2 

l* 

9# 

4 m 

42# 

6- 

13 


IB" 

23# 

11" 

6# 

11- 

7 

R3 

‘ 1" 

10# 

Am 

43# 

7- 

10 


9- 

7# 

9- 

33# 

9 — 

34# 

R4 

l* 

11# 

Am 

44# 

7- 

9 


8« 

31# 

1 1" 

11 

11- 

14# 

R5 

l" 

12# 

4 m 

48# 

8— 

6# 

SKIP2 

4" 

24# 

9 m 

25 



SMBS 1 Z 

2- 

1 88# 

2m 

159 

2- 

160 

SP 

1 m 

13# 

Am 

46# 

7- 

9# 


8" 

8 

8*» 

17# 

3 ■» 

23# 


10" 

28# 

ti- 

4 

H * 

' 5# 


11" 

17 

ll" 

18 



SPACES 

7 - 

20 





SPREAD 


8 

8- 

11 

5- 

47 


9" 

8 

9m 

16 

9- 

35 

STMASK 

1 • 

93# 





S.RSAV 

4" 

81# 

6m 

7 



TA0CH 

1 " 

122# 





UPPCA5 

0" 

34# 

7 - 

25 

10- 

12 

v ■ Cos 

1 " 

25# 





v.cdu 

1" 

26# 





V,OTB 

1" 

27# 





V.RLB 

1- 

28# 





V , RRE5 

1" 

24# 





V.RSAV 

1" 

23# 





V.3VT 

1" 

21# 





V • X I T 

1" 

22# 





WIDTH 

4" 

36 

&• 

15 

5- 

33 

XFTCOM 

3" 

7# 





xftqos 

a** 

13# 





XFTMUO 

3" 

9# 





xftrpg 

3" 

11# 





SSPASS 

2-177# 






6 — 

7 






7 m 

11 

7 — 

15# 

7- 

16 

10- 

17# 

1 1 - 

8# 

11- 

13 

11- 

17# 



7m 

1## 

7- 

27# 

8- 

23 

9— 

6# 

10- 

16 # 

10- 

22# 

11- 

12 

1 1 - 

18# 

7m 

13# 

7- 

32# 

7- 

37# 

8- 

29 

ti m 

8# 

10- 

18# 

11- 

19# 



7m 

10# 

7- 

11# 

7- 

12# 

8 — 

7# 

6m 

2»# 

8- 

30# 

0- 

31 

10- 

24# 

1 1* 

7# 

11- 

14 

11- 

15# 

1 1- 

16 

6 m 

15 

g «* 

20 

6- 

18 

8 — 

24 
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CROSS REFERENCE TABLE M-l 


AERROR 

2- 31# 

CALL 

2- 73# 

CALL® 

2* 39# 

CHKPNT 

2* 96# 

dial 

2-324# 

ERROR 

2- 18# 

ferror 

2- 28# 

fremsb 

2-251# 

GETBUF 

2-124# 

IERROR 

2- 39# 

ioterr 

2- 24# 

mqoend 

2-232# 

MQOSTA 

2-179# 

MQVMSB 

2-273# 

MOVSEG 

2-297# 

OUTMSB 

2-239# 

OVLNAM 

2-222# 

POP 

2- 63# 

PUSH 

2- 57# 

QORVR 

2-146# 

RELBUF 

2-138# 

RESREG 

2-107# 

retemt 

2-280# 

return 

2- 77# 

SAVREG 

2-102# 

SERROR 

2- 33# 

SETABS 

2-135# 

STOEV 

2-333# 

swpcal 

2- 84# 

WERROR 

2- 43# 


cross reference Table 

3552B 
. ASS , 35520 


C«l 
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